Move documentation to inline comments: GtkToggleToolButton

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index ae6f64520c26cdfb9f2091db61837dd64e204cf2..409c0e8bd58e92d6275bf2f7c1f8883f3c9ccee9 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -103,6 +103,7 @@ gtktexttag.sgml
 gtktexttagtable.sgml
 gtktextview.sgml
 gtktoggleaction.sgml
+gtktoggletoolbutton.sgml
 gtktoolbar.sgml
 gtktoolitem.sgml
 gtktooltip.sgml

diff --git a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml b/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
deleted file mode 100644 (file)
index 738e4b9..0000000
--- a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
+++ /dev/null
@@ -1,105 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkToggleToolButton
-
-<!-- ##### SECTION Short_Description ##### -->
-A GtkToolItem containing a toggle button
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-  A #GtkToggleToolButton is a #GtkToolItem that contains a toggle
-  button.
-</para>
-
-<para>
-  Use gtk_toggle_tool_button_new() to create a new
-  #GtkToggleToolButton. Use gtk_toggle_tool_button_new_from_stock() to
-  create a new #GtkToggleToolButton containing a stock item.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-
-<para>
-  <variablelist>
-    <varlistentry>
-      <term>#GtkToolbar</term>
-      <listitem><para>The toolbar widget</para></listitem>
-      <term>#GtkToolButton</term>
-      <listitem>
-        <para>
-          The parent class of #GtkToggleToolButton. The properties
-          "label_widget", "label", "icon_widget", and "stock_id" on
-          #GtkToolButton determine the label and icon used on
-          #GtkToggleToolButton<!-- -->s.
-        </para>
-      </listitem>
-      <term>#GtkSeparatorToolItem</term>
-      <listitem>
-        <para>A subclass of #GtkToolItem that separates groups of
-          items on a toolbar.
-        </para>
-      </listitem>
-    </varlistentry>
-  </variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkToggleToolButton ##### -->
-<para>
-  The #GtkToggleToolButton struct contains only private data and
-  should only be accessed through the functions described below.
-</para>
-
-
-<!-- ##### SIGNAL GtkToggleToolButton::toggled ##### -->
-<para>
-
-</para>
-
-@toggletoolbutton: the object which received the signal.
-
-<!-- ##### ARG GtkToggleToolButton:active ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_new_from_stock ##### -->
-<para>
-
-</para>
-
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_set_active ##### -->
-<para>
-
-</para>
-
-@button: 
-@is_active: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_get_active ##### -->
-<para>
-
-</para>
-
-@button: 
-@Returns: 
-
-

diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c
index e6cea93c9304bbcf5cbe7f28f09770f1826116d8..9207ca6341cac5b05744d25e4f266cbcb9fb9193 100644 (file)
--- a/gtk/gtktoggletoolbutton.c
+++ b/gtk/gtktoggletoolbutton.c
@@ -32,6 +32,21 @@
 #include "gtkprivate.h"
 
 
+/**
+ * SECTION:gtktoggletoolbutton
+ * @Short_description: A GtkToolItem containing a toggle button
+ * @Title: GtkToggleToolButton
+ * @See_also: #GtkToolbar, #GtkToolButton, #GtkSeparatorToolItem
+ *
+ * A #GtkToggleToolButton is a #GtkToolItem that contains a toggle
+ * button.
+ *
+ * Use gtk_toggle_tool_button_new() to create a new
+ * #GtkToggleToolButton. Use gtk_toggle_tool_button_new_from_stock() to
+ * create a new #GtkToggleToolButton containing a stock item.
+ */
+
+
 #define MENU_ID "gtk-toggle-tool-button-menu-id"
 
 enum {